home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 2 / MacMania 2.toast / Demo's / Tools&Utilities / Netwerk⁄Telecom / ftp'ing
Encoding:
Internet Message Format  |  1992-08-14  |  19.2 KB  |  [TEXT/QED1]
  1. Date: Wed, 24 Apr 91 23:40:21 -0700
  2. From: Raymond Beausoleil <beausol@milton.u.washington.edu>
  3.  
  4. About six weeks ago, Bob Jopson of Bell Labs asked me to write a short article 
  5. on the rudiments of "ftp'ing" for "Optics and Photonics News," the monthly 
  6. magazine for members of the Optical Society of America. He certainly didn't ask 
  7. *me* because I am an expert; rather, I'm a fairly typical user who knows just 
  8. enough Unix to ftp, read mail, etc.
  9.  
  10. With much help, I managed to write the two-part article below. The first part 
  11. covers the ftp process itself, while the second part describes some approaches 
  12. to downloading and decoding Mac and MS-DOS files from a Unix host to your 
  13. microcomputer. In particular, Mac folks can find out how to get mcvert up and 
  14. running on their system.
  15.  
  16. The article below is somewhat longer and more detailed than the edited version 
  17. that will appear in O&PN. If you like it, I recommend that you archive it in 
  18. the directory /info-mac/help as ftp-primer.txt.
  19.  
  20. Regards,
  21.  
  22. Ray Beausoleil
  23.  
  24. ----------------------------- Beginning of Part I ----------------------------
  25.  
  26. An FTP Primer I: The File Transfer Protocol
  27.  
  28. Ray Beausoleil
  29. beausol@u.washington.edu
  30.  
  31.    Some of the most capable software packages currently available for 
  32. microcomputers are publicly issued as either "freeware" or "shareware." 
  33. Freeware is generously released by the author without charge, while shareware 
  34. is distributed under a "try before you buy" agreement. Copies of many of these 
  35. programs are archived on mini and mainframe computers throughout the world. If 
  36. your local Unix site is connected to the INTERNET, then you may transfer these 
  37. files to your site and download them to your microcomputer.
  38.  
  39.    FTP is the INTERNET standard File Transfer Protocol. The program "ftp" is 
  40. the Unix user interface to the Internet protocol, and allows you to transfer 
  41. files to and from a remote network host. This article necessarily cannot serve 
  42. as an exhaustive description of the "anonymous FTP" process. (In fact, the Unix 
  43. "ftp" program is only one of many user interfaces to the INTERNET FTP.) 
  44. However, in Part I I will give an example of a typical Unix FTP session, and I 
  45. will list the addresses of a few archive sites for Macintosh and MS-DOS 
  46. software. Next month, in Part II, I will describe some of the techniques for 
  47. decoding and downloading this software to your microcomputer.
  48.  
  49.    FTP is a privilege granted to users of the INTERNET by the administrators of 
  50. sites containing these archives. Please try to restrict your file transfers to 
  51. non-business hours, because you and other FTP users can cause the host computer 
  52. to slow down significantly. In addition, please minimize the time that you are 
  53. connected to the remote site so that others may take advantage of the 
  54. opportunity.
  55.  
  56.    A screen capture of a typical (brief) FTP session is shown in Fig. 1. From a 
  57. Unix machine at the University of Washington ("milton"), I connected to sumex-
  58. aim.stanford.edu, where a large collection of Macintosh software is archived. 
  59. The numbers in parentheses located on the left margin of Fig. 1 correspond to 
  60. the annotations listed below.
  61.  
  62. (1)  At your Unix prompt, enter "ftp" followed by a space and either the name 
  63. or the numerical INTERNET address of the remote host. Occasionally, a host will 
  64. accept only the INTERNET address. If the remote site is active, then you will 
  65. be connected to the remote FTP server.
  66.  
  67. (2)  When the remote machine asks for your name, enter "anonymous." Some hosts 
  68. limit the number of off-site FTP users; if the number of connections has 
  69. already reached the maximum, you will be asked to try again later.
  70.  
  71. (3)  For your password, you are generally asked to enter your e-mail address, 
  72. such as "beausol@u.washington.edu," followed by a return. However, some systems 
  73. will permit you to enter virtually any text instead.
  74.  
  75. (4)  After these preliminaries, you will enter your local Unix "ftp" command 
  76. interpreter, which will provide you with the "ftp>" prompt. Usually, you will 
  77. first be logged in to a "root directory" that has been set aside for FTP 
  78. purposes by the system administrators; you must then navigate to the archive 
  79. itself. At sumex-aim.stanford.edu, the Macintosh software archive is located in 
  80. the directory "info-mac." You can change the current working directory on the 
  81. remote host using the "cd" command. In the example of Fig. 1, I have also moved 
  82. to the subdirectory "util" on the info-mac directory. Whenever you have 
  83. finished with a particular subdirectory, enter "cdup" at the "ftp>" prompt to 
  84. move up one directory level.
  85.  
  86. (5)  Enter "get" followed by a space and the name of the file to be 
  87. transferred. The file will then be copied to your local Unix directory. In the 
  88. example of Fig. 1, the ".hqx" extension indicates that the Macintosh file has 
  89. been encoded as purely ASCII characters using BinHex (discussed in more detail 
  90. in Part II.) Usually, ASCII is the default FTP transfer mode. However, if the 
  91. file has been archived in binary format, then at the "ftp>" prompt, and prior 
  92. to transferring the file, you must enter "binary." Sometimes, if the file is 
  93. large and the remote system is busy, the transfer may take considerable time. 
  94. To keep an eye on the progress of the transfer, enter "hash" before getting the 
  95. file; then as each 1024-byte block of data is transferred, a "#" hash mark will 
  96. be printed on your monitor. If you would like to see an abbreviated list of the 
  97. files contained in the current directory, enter "ls"; for a more verbose list 
  98. that includes information about each file's size and the date that it was 
  99. archived, enter "dir" followed by a carriage return.
  100.  
  101. (6)  When you are finished transferring the files you need, be courteous and 
  102. log off of the remote machine as quickly as possible. At the "ftp>" prompt, 
  103. enter either "by" or "qui."
  104.  
  105.    These are the most basic commands that you will use during any FTP session. 
  106. You can usually find a complete description of the FTP command interpreter used 
  107. at your Unix site by viewing the "manual pages" (i.e., by entering "man ftp").
  108.  
  109.    There are a number of archives of software for the Macintosh, IBM PC and 
  110. compatibles, and other popular personal computers. In Table I, I have listed 
  111. the name of the host, the Internet address, the directory containing the 
  112. archive, the microcomputer, and the appropriate transfer mode for some of the 
  113. most popular archives. (Of course, virtually all documentation files are stored 
  114. as pure ASCII.) One of the largest and most frequently updated Macintosh 
  115. software archives is maintained at sumex-aim.stanford.edu. I recommend that the 
  116. inexperienced user explore the subdirectory /info-mac/help. OzTeX, the free 
  117. Macintosh implementation of TeX mentioned by Tony Siegman in last month's 
  118. column, may be found at midway.uchicago.edu (University of Chicago); it is 
  119. quite large, so be prepared! The MS-DOS archive at wsmr-simtel20.army.mil 
  120. (White Sands Missile Range) is enormous, but it is difficult to navigate 
  121. because the host does not use Unix. Nevertheless, there are a number of text 
  122. documents in the root directory that describe the FTP commands for the simtel20 
  123. server. A Unix mirror of the simtel20 archive is maintained at 
  124. wuarchive.wustl.edu (Washington University at St. Louis); if you are new to FTP 
  125. on the IBM PC, then an excellent place to begin is the wuarchive subdirectory 
  126. /mirrors/msdos/starter.
  127.  
  128.    The best way to learn more about FTP and other microcomputer archives is to 
  129. subscribe to the appropriate INTERNET news groups. A full description of 
  130. INTERNET news groups is beyond the scope of this article; you'll need to list 
  131. the manual pages for your system news reader or to contact your local system 
  132. administrator to get started. However, news groups of interest to microcomputer 
  133. users have names that begin with prefixes like "comp.sys.mac..." and 
  134. "comp.sys.ibm.pc..." In particular, the news groups "comp.sys.mac.digest" and 
  135. "comp.sys.ibm.pc.d" describe in detail new additions to the archives at sumex-
  136. aim and simtel20, respectively.
  137.  
  138.    The precise implementation of FTP is site-dependent, so "your mileage may 
  139. vary." But the basics of file transfer are usually easy to master and are well 
  140. worth the effort. Next month, I will describe the basics of decoding and 
  141. downloading files obtained via FTP.
  142.  
  143. (I am grateful to Geoff Kinnel, Betsy Richards, Geoff Allen, and Jim Matthews 
  144. for their generous assistance in gathering information for this article.)
  145.  
  146. (C) Copyright 1991 Raymond G. Beausoleil
  147.  
  148.  
  149.  
  150.  
  151. Figure 1: Screen Capture of an ftp session.
  152.  
  153. (1)   milton> ftp 36.44.0.6
  154.       Connected to 36.44.0.6.
  155.       220 sumex-aim FTP server (SunOS 4.0/3) ready.
  156. (2)   Name (36.44.0.6:beausol): anonymous
  157.       331 Guest login ok, send mail address (user@host) as password.
  158. (3)   Password:
  159.       230 Guest connection 7 (of 25) accepted, access restrictions apply.
  160. (4)   ftp> cd /info-mac/util
  161.       250 CWD command successful.
  162. (5)   ftp> get unstuffit-deluxe-20.hqx
  163.       200 PORT command successful.
  164.       150 ASCII data connection for unstuffit-deluxe-20.hqx
  165.       (128.95.136.1,11969) (172867 bytes).
  166.       226 ASCII Transfer complete.
  167.       local: unstuffit-deluxe-20.hqx remote: unstuffit-deluxe-20.hqx
  168.       175534 bytes received in 7.2 seconds (24 Kbytes/s)
  169. (6)   ftp> by
  170.       221 Goodbye.
  171.  
  172.  
  173. Table I:
  174.  
  175. Site Name               IP Address      Directory       Software   Mode
  176. ------------------------------------------------------------------------
  177. sumex-aim.stanford.edu  36.44.0.6       /info-mac        Mac      ASCII
  178. midway.uchicago.edu     128.135.12.73   /pub/OzTeX/oztex Mac      Binary
  179. wsmr-simtel20.army.mil  26.2.0.74       Non-Unix!        MS-DOS   Binary
  180. wuarchive.wustl.edu     128.252.135.4   /mirrors/msdos   MS-DOS   Binary
  181.  
  182. --------------------------------- End of Part I ------------------------------
  183.  
  184. ----------------------------- Beginning of Part II ---------------------------
  185.  
  186. An FTP Primer II: Downloading and Decoding 
  187.  
  188. Ray Beausoleil
  189. beausol@u.washington.edu
  190.  
  191.    Last month, in Part I of this article, I briefly described the INTERNET File 
  192. Transfer Protocol (FTP). In particular, I demonstrated how to use the Unix 
  193. "ftp" interface to transfer personal computer software packages from a remote 
  194. archive to your local Unix mainframe or minicomputer. These programs have 
  195. usually been compressed and/or encoded by the archive administrators. This 
  196. month, I will provide a brief introduction to the process of first downloading 
  197. this software to your microcomputer, and then decoding it using special utility 
  198. programs. 
  199.  
  200.    The method that you must use to download software from your local mainframe 
  201. computer to your microcomputer depends on the operating system and the software 
  202. installed on the mainframe, and on the configuration of your network (e.g., 
  203. Ethernet or modem). You should begin by asking your system administrator for a 
  204. list of information transfer protocols that have been installed at your site 
  205. and the commands that invoke these protocols. Some of the most popular 
  206. protocols include XModem, YModem, ZModem, and Kermit. Paul Kelley has described 
  207. XModem and Kermit in his article "Information transfer for personal computers," 
  208. published in the February 1991 edition of this column.
  209.  
  210.    In Tables I and II, I have listed freeware and shareware telecommunications 
  211. and utility software packages for the Macintosh and the IBM PC, respectively. 
  212. For Macintosh software, I recommend the archive at sumex-aim.stanford.edu 
  213. (INTERNET address 36.44.0.6), located in the directory "/info-mac". ZTerm, an 
  214. excellent shareware telecommunications application program, can be found in the 
  215. directory "/info-mac/comm". ZTerm not only uses the XModem and YModem data 
  216. transfer protocols, but also offers one of the best implementations of the 
  217. ZModem protocol for any personal computer. When you are connected through ZTerm 
  218. to a Unix mainframe that uses the ZModem protocol, you may download a file 
  219. simply by entering "sz" followed by a space and the name of the file. ZTerm 
  220. detects that a file is being sent, identifies the file type, and then chooses 
  221. the correct transfer mode! For local systems which have implemented the Kermit 
  222. protocol, the program MacKermit (also available at sumex-aim.stanford.edu in 
  223. the "/info-mac/comm" directory) provides a robust Macintosh interface.
  224.  
  225.    A huge archive of IBM PC software is maintained at wuarchive.wustl.edu 
  226. (INTERNET address 128.252.135.4), in the directory "/mirrors/msdos". The most 
  227. popular shareware telecommunications package for the IBM PC, ProComm, may be 
  228. found there in the subdirectory named (oddly enough) "procomm". ProComm uses 
  229. the XModem, YModem, and Kermit transfer protocols, and can also follow the 
  230. ZModem protocol through an external command shell using the transfer program 
  231. "DSZ.COM", which should be placed in the same MS-DOS directory as the ProComm 
  232. program itself. After connecting to your local Unix mainframe through ProComm, 
  233. enter "sz" followed by a space and the name of the file to be downloaded. Then, 
  234. through ProComm, enter the MS-DOS gateway (the "DOS shell") and input "dsz rz" 
  235. at the MS-DOS prompt. After the file has been written to your personal 
  236. computer's disk, simply enter "exit" at the DOS prompt to return to ProComm.
  237.  
  238.    As Paul Kelley mentioned in his article, the simplest way to download files 
  239. to your microcomputer is to display the file on your monitor. Both ZTerm and 
  240. Procomm allow you to capture incoming text and write the text to a disk file. 
  241. As described below, you may then decode the files for later use. Almost all of 
  242. the files stored in the large archive of Macintosh software maintained at 
  243. sumex-aim.stanford.edu have been encoded as ASCII (text) characters using a 
  244. format known as BinHex 4. These files have names that end with the extension 
  245. ".hqx", and can be captured directly from your monitor after you have 
  246. transferred them to your local Unix host. You may direct a Unix machine to 
  247. write a ".hqx" file to your monitor by entering the command "cat", followed by 
  248. a space and the name of the file to be transferred. However, almost all of the 
  249. files stored in the IBM PC software archive wuarchive.wustl.edu have been 
  250. stored in binary format. After you have transferred one of these files (e.g., 
  251. "file.arc") to your local Unix mainframe or minicomputer, you can use the 
  252. command "uuencode file.arc file.arc" to ASCII-encode "file.arc" and then write 
  253. it to your monitor. In both cases, you must decode the ASCII file on your 
  254. microcomputer using one of the utility programs listed in Tables I and II; 
  255. since you will not be able to decode these utilities themselves until after you 
  256. have the utilities, you must obtain copies of their binary executable files 
  257. from a colleague or user group.
  258.  
  259.    A typical binary file can be up to 50% smaller than the corresponding 
  260. encoded ASCII file, and can be transferred to your personal computer in 
  261. proportionally less time. Therefore, if at all possible, you should try to 
  262. download using the binary transfer mode. This is relatively straightforward for 
  263. IBM PC files transferred from the wuarchive.wustl.edu archive and then 
  264. downloaded to a microcomputer using ProComm Plus.
  265.  
  266.    You may decode BinHex Macintosh files into MacBinary files on your local 
  267. Unix host prior to downloading them using a utility such as "mcvert." You may 
  268. build your own copy of "mcvert" by following these steps: (1) transfer the file 
  269. "mcvert-15.shar" from the "/info-mac/unix" subdirectory at sumex-
  270. aim.stanford.edu using "ftp"; (2) enter "sh mcvert-15.shar" at your local Unix 
  271. prompt, and ignore any error messages caused by the file header; and (3) enter 
  272. "make" at the Unix prompt. This process will create a number of files on your 
  273. directory; you may delete all but "mcvert" itself. Now, to decode any files 
  274. that have the extension ".hqx" (including files that consist of more than one 
  275. part), simply enter "mcvert *.hqx" at the Unix prompt. Your Unix directory will 
  276. then contain files with the extension ".bin", which can be downloaded using the 
  277. MacBinary transfer mode.
  278.  
  279.    Both the Macintosh and the IBM PC binary files that you have downloaded to 
  280. your personal computer are actually miniature archives that contain one or more 
  281. compressed executable and/or data files. These archives can be easily and 
  282. rapidly expanded using the appropriate utility files listed in Tables I and II. 
  283. (The label "sea" designates self-extracting archives which will decompress 
  284. themselves automatically upon launching.) On the Macintosh, files obtained from 
  285. sumex-aim.stanford.edu will usually have extensions such as ".sit" (Stuffit 
  286. Classic), ".cpt" (Compact Pro), or ".sea" (Compact Pro self-extracting 
  287. archive). On the IBM PC, files transferred and downloaded from 
  288. wuarchive.wustl.edu will have extensions such as ".ARC" (PKUNPAK.EXE), ".ZIP" 
  289. (PKUNZIP.EXE), ".LHZ" (LHARC.EXE), ".ZOO" (LOOZ210.EXE), or ".EXE" (self-
  290. extracting archive or simple executable file).
  291.  
  292.    At first, the downloading and decoding process may seem daunting to you, 
  293. particularly if either the system architecture of your local host is not Unix, 
  294. or the software installed on that system does not follow one of the few 
  295. examples that I have given in this article. Rest assured that others have 
  296. almost certainly solved your problems already; one of your most dependable 
  297. resources is the knowledge of your colleagues. Alternatively, as I mentioned 
  298. briefly in Part I, you may learn more about personal computer 
  299. telecommunications by subscribing to the appropriate INTERNET news groups. If 
  300. you ask the right people the right questions, you might find that while you may 
  301. not be able stand upon the shoulders of giants, you may be able to stand upon 
  302. their feet.
  303.  
  304. (I am grateful to John McGarvey, Matt Derstine, Geoff Kinnel, Betsy Richards, 
  305. David Faust, and Geoff Allen for their generous assistance in gathering 
  306. information for this article.)
  307.  
  308. (C) Copyright 1991 Raymond G. Beausoleil
  309.  
  310. Table I: Files obtained from sumex-aim.stanford.edu (36.44.0.6) in the
  311.          directory /info-mac (ASCII Transfer Mode)
  312.  
  313. File Name              Location            Description
  314. -----------------------------------------------------------------------
  315. file-types.txt           help      Brief list of sumex-aim file types
  316. zterm-085.hqx            comm      ZTerm (X,Y,ZModem; no Kermit)
  317. mackermit-098.hqx        comm      MacKermit (No X,Y,ZModem)
  318. stuffit-16-part1.hqx     util      Stuffit Classic w/BinHex 4 (sea)
  319. stuffit-16-part2.hqx     util
  320. compact-pro-13.hqx       util      Compact Pro w/BinHex 4 (sea)
  321. mcvert-15.shar           unix      Unix shell archive for mcvert
  322.  
  323.  
  324.  
  325. Table II: Files obtained from wuarchive.wustl.edu (128.252.135.4) in the
  326.           directory /mirrors/msdos (Binary Transfer Mode)
  327.  
  328. File Name           Location            Description
  329. -----------------------------------------------------------------------
  330. 00-files.doc        starter   Description of wuarchive file types
  331. 00-index.txt        starter   Descriptions of files in /starter
  332. prcm243.arc         procomm   ProComm shareware communications program
  333. prcm243d.arc        procomm   ProComm documentation
  334. prcm243d.arc        procomm   ProComm utilities
  335. dsz0404.zip         zmodem    DSZ.COM (ZModem for ProComm)
  336. pk361.exe           starter   PKPAK.EXE/PKUNPAK.EXE (sea)
  337. pkz110eu.exe        starter   PKZIP.EXE/PKUNZIP.EXE (sea)
  338. lh113c.exe          starter   LHARC.EXE (sea)
  339. looz210.com         starter   ZOO archive extracter/lister
  340. uudecode.com        starter   Convert ASCII uuencoded files to binary
  341.  
  342. --------------------------------- End of Part II -----------------------------
  343.  
  344.